home *** CD-ROM | disk | FTP | other *** search
- <?xml version='1.0' encoding='UTF-8' ?>
- <!DOCTYPE manualpage SYSTEM "./style/manualpage.dtd">
- <?xml-stylesheet type="text/xsl" href="./style/manual.es.xsl"?>
- <!-- English Revision: 1.11.2.17 -->
-
- <!--
- Copyright 2004 The Apache Software Foundation
-
- Licensed under the Apache License, Version 2.0 (the "License");
- you may not use this file except in compliance with the License.
- You may obtain a copy of the License at
-
- http://www.apache.org/licenses/LICENSE-2.0
-
- Unless required by applicable law or agreed to in writing, software
- distributed under the License is distributed on an "AS IS" BASIS,
- WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- See the License for the specific language governing permissions and
- limitations under the License.
- -->
-
- <manualpage metafile="install.xml.meta">
-
- <title>Compilación e Instalación</title>
-
- <summary>
-
- <p>Este documento explica cómo compilar e instalar Apache en
- sistemas Unix y tipo Unix. Para obtener información sobre
- cómo compilar e instalar en Windows, consulte la sección
- <a href="platform/windows.html">Usar Apache en Microsoft
- Windows</a>. Para otras plataformas, consulte la
- documentación sobre <a href="platform/">plataformas</a>.</p>
-
- <p>El entorno de configuración e instalación de Apache
- 2.0 ha cambiado completamente respecto al de Apache 1.3. Apache
- 1.3 usaba un conjunto de scripts a medida para conseguir una
- instalación fácil. Apache 2.0 usa <code>libtool</code> y
- <code>autoconf</code> para crear un entorno más parecido al
- de muchos otros proyectos Open Source.</p>
-
- <p>Si lo que quiere hacer es actualizar su servidor Apache desde
- una versión menor (por ejemplo, desde la 2.0.50 a la 2.0.51),
- pase directamente a la sección de <a
- href="#upgrading">actualización</a>.</p>
-
- </summary>
-
- <seealso><a href="programs/configure.html">Configuración de la
- estructura de directorios</a></seealso> <seealso><a
- href="invoking.html">Iniciar Apache</a></seealso> <seealso><a
- href="stopping.html">Parar y reiniciar Apache</a></seealso>
-
- <section id="overview"><title>Visión general del proceso para
- impacientes</title>
-
- <table>
- <columnspec><column width=".13"/><column
- width=".80"/></columnspec>
- <tr>
- <td><a href="#download">Descargar</a></td>
-
- <td><code>$ lynx http://httpd.apache.org/download.cgi</code>
- </td>
- </tr>
-
- <tr>
- <td><a href="#extract">Descomprimir</a></td>
-
- <td><code>$ gzip -d httpd-2_0_<em>NN</em>.tar.gz<br />
- $ tar xvf httpd-2_0_<em>NN</em>.tar</code> </td>
- </tr>
-
- <tr>
- <td><a href="#configure">Ejecutar el script configure</a></td>
-
- <td><code>$ ./configure --prefix=<em>PREFIX</em></code>
- </td>
- </tr>
-
- <tr>
- <td><a href="#compile">Compilar</a></td>
-
- <td><code>$ make</code> </td>
- </tr>
-
- <tr>
- <td><a href="#install">Instalar</a></td>
-
- <td><code>$ make install</code> </td>
- </tr>
-
- <tr>
- <td><a href="#customize">Personalizar</a></td>
-
- <td><code>$ vi <em>PREFIX</em>/conf/httpd.conf</code> </td>
- </tr>
-
- <tr>
- <td><a href="#test">Comprobar que la instalación
- funciona</a></td>
-
- <td><code>$ <em>PREFIX</em>/bin/apachectl start</code>
- </td>
- </tr>
- </table>
-
- <p><em>NN</em> hay que reemplazarlo por el número de la
- versión menor, y <em>PREFIX</em> hay que reemplazarlo por la
- ruta en la que se va a instalar Apache. Si no especifica
- ningún valor en <em>PREFIX</em>, el valor por defecto que se
- toma es <code>/usr/local/apache2</code>.</p>
-
- <p>Cada parte del proceso de configuración e instalación
- se describe detalladamente más abajo, empezando por los
- requisitos para compilar e instalar Apache.</p>
- </section>
-
- <section id="requirements"><title>Requisitos</title>
-
- <p>Estos son los requisitos necesarios para compilar Apache:</p>
-
- <dl>
- <dt>Espacio en disco</dt> <dd>Compruebe que tiene disponibles al
- menos 50 MB de espacio libre en disco. Después de la
- instalación, Apache ocupa aproximadamente 10 MB. No
- obstante, la necesidad real de espacio en disco varía
- considerablemente en función de las opciones de
- configuración que elija y de los módulos externos que
- use.</dd>
-
- <dt>Compilador ANSI-C y Build System</dt> <dd>Compruebe que
- tiene instalado un compilador de ANSI-C. Se recomienda el <a
- href="http://www.gnu.org/software/gcc/gcc.html">Compilador GNU C
- (GCC)</a> de la <a href="http://www.gnu.org/">Free Software
- Foundation (FSF)</a> (con la versión 2.7.2 es
- suficiente). Si no tiene instaldo el GCC, entonces compruebe que
- el compilador que va a utilizar cumple con los estándares
- ANSI. Además, su <code>PATH</code> debe contener la
- ubicación donde de encuentran las herramientas básicas
- para compilar tales como <code>make</code>.</dd>
-
- <dt>Ajuste exacto del reloj del sistema</dt> <dd>Los elementos
- del protocolo HTTP están expresados según la hora del
- dia. Por eso, si quiere puede investigar como instalar alguna
- utilidad para sincronizar la hora de su sistema. Para esto,
- normalmente, se usan los programas <code>ntpdate</code> o
- <code>xntpd</code>, que están basados en el protocolo
- Network Time Protocol (NTP). Consulte el grupo de noticias <a
- href="news:comp.protocols.time.ntp">comp.protocols.time.ntp</a>
- y el <a href="http://www.eecis.udel.edu/~ntp/">sitio web de NTP
- </a> para obtener más información sobre NTP y los
- servidores públicos de tiempo.</dd>
-
- <dt><a href="http://www.perl.org/">Perl 5</a> [OPCIONAL]</dt>
- <dd>Para algunos de los scripts de soporte como <a
- href="programs/apxs.html">apxs</a> o <a
- href="programs/dbmmanage.html">dbmmanage</a> (que están
- escritos en Perl) es necesario el intérprete de Perl 5 (las
- versiones 5.003 o posteriores son suficientes). Si el script
- `<code>configure</code>' no encuentra ese intérprete
- tampoco pasa nada. Aún puede compilar e instalar Apache
- 2.0. Lo único que ocurrirá es que esos scripts de
- soporte no podrán ser usados. Si usted tiene varios
- interpretes de Perl instalados (quizás Perl 4 porque estaba
- ya incluido en su distribución de Linux y Perl 5 porque lo
- ha instalado usted), entonces se recomienda usar la opción
- <code>--with-perl</code> para asegurarse de que
- <code>./configure</code> usa el intérprete correcto.</dd>
- </dl>
- </section>
-
- <section id="download"><title>Descargar</title>
-
- <p>Puede descargar Apache desde <a
- href="http://httpd.apache.org/download.cgi">la sección de
- descargas del sitio web de Apache</a> el cual tiene varios
- mirrors. Para la mayoría de los usuarios de Apache que tienen
- sistemas tipo Unix, se recomienda que se descarguen y compilen el
- código fuente. El proceso de compilación (descrito
- más abajo) es fácil, y permite adaptar el servidor
- Apache a sus necesidades. Además, las versiones de
- disponibles en archivos binarios no están siempre actulizadas
- con las últimas modificaciones en el codigo fuente. Si se
- descarga un binario, siga las instrucciones contenidas en el
- archivo <code>INSTALL.bindist</code> incluido en la
- distribución</p>
-
- <p>Después de la descarga, es importante que verifique que el
- archivo descargado del servidor HTTP Apache está completo y
- sin modificaciones. Esto puede hacerlo comparando el archivo
- descargado (.tgz) con su firma PGP. Instrucciones detalladas de
- cómo hacer esto están disponibles en <a
- href="http://httpd.apache.org/download.cgi#verify"> la
- sección de descargas</a> junto con un ejemplo de cómo <a
- href="http://httpd.apache.org/dev/verification.html">usar
- PGP</a>.</p>
-
- </section>
-
- <section id="extract"><title>Descomprimir</title>
-
- <p>Extraer el código fuente del archivo .tgz que acabada de
- descargar es muy fácil. Ejecute los siguientes comandos:</p>
-
- <example>
- $ gzip -d httpd-2_0_<em>NN</em>.tar.gz<br />
- $ tar xvf httpd-2_0_<em>NN</em>.tar
- </example>
-
- <p>Estos comandos crearán un nuevo directorio dentro del
- directorio en el que se encuentra y que contendrá el
- código fuente de la distribución. Debe cambiarse a ese
- directorio con <code>cd</code> para proceder a compilar el
- servidor Apache.</p>
-
- </section>
-
- <section id="configure"><title>Configuración de la estructura de
- directorios</title>
-
- <p>El siguiente paso es configurar la estructura de directorios
- para su plataforma y sus necesidades personales. Esto se hace
- usando el script <code>configure</code> incluido en el directorio
- raiz de la distribución que acaba de descargar. (Los
- desarrolladores que se descarguen la versión del CVS de la
- estructura de directorios necesitarán tener instalados
- <code>autoconf</code> y <code>libtool</code>, y necesitarán
- ejecutar <code>buildconf</code> antes de continuar con los
- siguientes pasos. Esto no es preciso para las versiones
- oficiales.)</p>
-
- <p>Para configurar la estructura de directorios a partir del
- código fuente usando las opciones por defecto, solo tiene que
- ejecutar <code>./configure</code>. Para cambiar las opciones por
- defecto, <code>configure</code> acepta una serie de variables y
- opciones por la línea de comandos.</p>
-
- <p>La opción más importante es <code>--prefix</code> que
- es el directorio en el que Apache va a ser instalado después,
- porque Apache tiene que ser configurado para el directorio que se
- especifique para que funcione correctamente. Es posible lograr un
- mayor control del lugar donde se van a instalar los ficheros de
- Apache con otras <a
- href="programs/configure.html#installationdirectories">opciones de
- configuración</a>.</p>
-
- <p>En este momento, puede especificar que <a
- href="programs/configure.html#optionalfeatures">características
- o funcionalidades</a> quiere incluir en Apache activando o
- desactivando <a href="mod/">módulos</a>. Apache viene con
- una <a href="mod/module-dict.html#Status">selección
- básica</a> de módulos incluidos por defecto. Se pueden
- activar otros módulos usando la opción
- <code>--enable-<var>module</var></code>, donde <var>module</var>
- es el nombre del módulo sin el <code>mod_</code> y
- convirtiendo los guiones bajos que tenga en guiones normales.
- También puede optar por compilar módulos como <a
- href="dso.html">objetos dinámicos compartidos (DSOs)</a> --
- que pueden ser activados o desactivados al ejecutar -- usando la
- opción <code>--enable-<var>module</var>=shared</code>. De
- igual manera, puede desactivar alguno de los módulos que
- vienen por defecto en la selección basica con la opción
- <code>--disable-<var>module</var></code>. Tenga cuidado cuando
- use estas opciones, porque <code>configure</code> no le
- avisará si el módulo que especifica no existe;
- simplemente ignorará esa opción.</p>
-
- <p>Además, a veces es necesario pasarle al script
- <code>configure</code> información adicional sobre donde esta
- su compilador, librerias o ficheros de cabecera. Esto se puede
- hacer, tanto pasando variables de entorno, como pasandole opciones
- a <code>configure</code> a través de la línea de
- comandos. Para más información, consulte la <a
- href="programs/configure.html">página de ayuda del script
- configure</a>.</p>
-
- <p>Para que se haga una idea sobre las posibilidades que tiene,
- aquí tiene un ejemplo típico que configura Apache para
- la ruta <code>/sw/pkg/apache</code> con un compilador y unos flags
- determinados, y además, con dos módulos adicionales
- <module>mod_rewrite</module> y <module>mod_speling</module> para
- cargarlos después a través del mecanismo DSO:</p>
-
- <example>
- $ CC="pgcc" CFLAGS="-O2" \<br />
- ./configure --prefix=/sw/pkg/apache \<br />
- --enable-rewrite=shared \<br />
- --enable-speling=shared
- </example>
-
- <p>Cuando se ejecuta <code>configure</code> se comprueban que
- características o funcionalidades están disponibles en
- su sistema y se crean los Makefiles que serán usados luego
- para compilar el servidor. Esto tardará algunos minutos.</p>
-
- <p>La información sobre todas las opciones de
- <code>configure</code> está disponible en el <a
- href="programs/configure.html">Manual del script
- configure</a>.</p>
-
- </section>
-
- <section id="compile"><title>Compilar</title>
-
- <p>Ahora puede compilar las diferentes partes que forman Apache
- simplemente ejecutando el siguiente comando:</p>
-
- <example>$ make</example>
-
- <p>Por favor, tanga un poco de paciencia ahora, porque una
- configuración básica tarda aproximadamente 3 minutos en
- compilar en un Pentium III con un sistema Linux 2.2, pero este
- tiempo puede variar considerablemente en función de su
- hardware y del número de módulos que haya
- seleccionado.</p>
- </section>
-
- <section id="install"><title>Instalar</title>
-
- <p>Ahora es el momento de instalar el paquete en el diretorio
- elegido en <em>PREFIX</em> (consulte la opción
- <code>--prefix</code> más arriba) ejecutando:</p>
-
- <example>$ make install</example>
-
- <p>Si usted está solo actualizando una instalación
- anterior, la nueva instalación no sobreescribirá sus
- ficheros de configuración ni otros documentos.</p>
- </section>
-
- <section id="customize"><title>Personalizar</title>
-
- <p>El paso siguiente, es personalizar su servidor Apache editando
- los <a href="configuring.html">ficheros de configuración</a>
- que están en <code><em>PREFIX</em>/conf/</code>.</p>
-
- <example>$ vi <em>PREFIX</em>/conf/httpd.conf</example>
-
- <p>échele un vistazo al Manual de Apache que está en <a
- href="./">docs/manual/</a> o consulte en <a
- href="http://httpd.apache.org/docs-2.0/"
- >http://httpd.apache.org/docs-2.0/</a> la versión más
- reciente de este manual y la Guia de Referencia de todas las <a
- href="mod/directives.html">directivas de configuración</a>
- disponibles.</p>
- </section>
-
- <section id="test"><title>Comprobar que la instalación
- funciona</title>
-
- <p>Ahora puede <a href="invoking.html">iniciar</a> su servidor
- Apache cuando quiera ejecutando:</p>
-
- <example>$ <em>PREFIX</em>/bin/apachectl start</example>
-
- <p>y entonces debe poder acceder al documento que tenga
- especificado por defecto usando el siguiente URL:
- <code>http://localhost/</code>. El documento que verá
- estará en <directive module="core">DocumentRoot</directive> y
- casi siempre estará en <code><em>PREFIX</em>/htdocs/</code>.
- Si quiere <a href="stopping.html">parar</a> el servidor, puede
- hacerlo ejecutando:</p>
-
- <example>$ <em>PREFIX</em>/bin/apachectl stop</example>
- </section>
- <section id="upgrading"><title>Actualizar una instalación
- prrevia</title>
-
- <p>El primer paso para actualizar una instalación anterior es
- leer las especificaciones de la versión y el fichero
- <code>CHANGES</code> en la distribución de código fuente
- que ha descargado para encontrar los cambios que puedan afectar a
- su instalación actual. Cuando el cambio sea entre versiones
- mayores (por ejemplo, de la 1.3 a la 2.0 o de la 2.0 a la 2.2),
- entonces es más probable que haya diferencias importantes en
- la compilación y en la ejecución que necesitarán
- ajustes manuales. Todos los módulos necesitarán
- también ser actualizados para adaptarse a los cambios en el
- interfaz de programación (API) de módulos.</p>
-
- <p>La actualización cuando el cambio es entre versiones
- menores (por ejemplo, de la 2.0.55 a la 2.0.57) es más
- fácil. El proceso <code>make install</code> no
- sobreescribirá ninguno de los documentos existentes, archivos
- log, o archivos de configuración. Además, los
- desarrolladores hacen todos los esfuerzos posibles para evitar
- cambios que generen incompatibilidades en las opciones de
- <code>configure</code>, en la configuración de la
- ejecución o en la interfaz de programación de
- módulos. En la mayor parte de los casos debe poder usar un
- comando <code>configure</code> idéntico, un fichero de
- configuracién idéntico, y todos sus módulos deben
- seguir funcionando. (Esto es válido solo para versiones
- posteriores a la 2.0.41; las versiones anteriores contienen
- cambios incompatibles.)</p>
-
- <p>Si va a conservar la estructura de directorios de su anterior
- instalación, la actualización es más fácil
- incluso. El fichero <code>config.nice</code> que está en el
- directorio raiz de la estructura de directorios antigua contiene
- exactamente el comando <code>configure</code> que usted usó
- para configurar la estructura de directorios de Apache. Entonces,
- para actualizar su instalación de una versóon a la
- siguinete, solo tiene que copiar el archivo
- <code>config.nice</code> a la estructura de directorios del
- código fuente de la nueva versión, editarlo, hacer
- cualquier cambio que desee, y ejecutarlo :</p>
-
- <example>
- $ ./config.nice<br />
- $ make<br />
- $ make install<br />
- $ <em>PREFIX</em>/bin/apachectl stop<br />
- $ <em>PREFIX</em>/bin/apachectl start<br />
- </example>
-
- <note type="warning">Tenga en cuenta que antes de poner una nueva
- versión de Apache en producción, debe siempre probarla
- antes en su entorno. Por ejemplo, puede instalar y ejecutar la
- nueva versión junto con la antigua usando un
- <code>--prefix</code> diferente y un puerto diferente (modificando
- la directiva <directive module="mpm_common">Listen</directive>)
- para comprobar que no existe ninguna incompatibilidad antes de
- hacer la actualización definitiva.</note>
- </section>
- </manualpage>
-
-